home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-20 / pbq.zip / PBQ.DOC < prev    next >
Text File  |  1991-09-21  |  4KB  |  99 lines
  1. PBQ - Pacsat Broadcast Queue/Query Purge
  2.  
  3. Copyright 1991 Paul Williamson, KB5MU
  4. You may use this program for non-commercial purposes.
  5.  
  6.  
  7. PBQ is another one-night hack program designed to make using the
  8. Pacsats with PG and PB less frustrating.
  9.  
  10. The Problem
  11. ===========
  12. When you receive files from a Pacsat using the Pacsat Broadcast
  13. Protocol and G0/K8KA's program PB, each file that is partially
  14. received is saved in a pair of files.  The next time you run PB,
  15. those files are read in so that PB can continue to fill in the holes
  16. in the files.  That's great, except that PB can only work on a limited
  17. number of files at the same time.  The queue of files-in-progress
  18. rapidly fills up, and then you can't receive any more broadcast files!
  19. This is a severe limitation, and I'm sure G0/K8KA will soon issue an
  20. improved PB that relieves or eliminates this problem.
  21.  
  22. The (Temporary) Solution
  23. ========================
  24. In the meantime, use PBQ.  When you run PBQ, it goes through the
  25. partially received files one by one.  It presents to you all the
  26. information it can dig up about the file by reading its "hole" file
  27. and by looking it up in the directory downloaded by PG.  You then
  28. make a decision about this file:
  29.  
  30.      1.    You can decide to continue to receive the file on the next
  31.     pass, in which case PBQ does nothing to the file.  Use this
  32.     option when you're interested in the file.
  33.  
  34.      2.    You can decide to delete the partial files, in which case
  35.     PBQ automatically does so.  In that case, if you hear that file
  36.     being broadcast again later, PB will try again to receive it,
  37.     starting from scratch.  Use this option when you're not
  38.     interested in the file and you think you'll probably never
  39.     hear it broadcast again.
  40.  
  41.      3. You can decide that you never want that file to bother you
  42.     again.  In that case, PBQ will not only delete the partial
  43.     files, it also creates a fake .DL file.  This will fool PB
  44.     into thinking you've already successfully downloaded that
  45.     file, so it won't allow that file onto the broadcast queue
  46.     again.
  47.  
  48. Running PBQ
  49. ===========
  50. PBQ uses many of the same files as PB and PG, so you must run it in
  51. the same directory where you run PB and PG (typically one directory
  52. per satellite).  After each pass (or just when your broadcast queue
  53. seems dangerously full), just run PBQ from the DOS prompt.  Each
  54. file will be described on the screen, and you hit a key to indicate
  55. what you want to do with that file.  That's all there is to it.
  56.  
  57. PBQ Deletes OLH Files
  58. =====================
  59. PB leaves a backup hole file named xxx.OLH for each file it receives.
  60. These files serve no purpose I'm aware of, and they clutter up the
  61. directory.  So, PBQ unilaterally deletes them.  There is no warning
  62. (except the one you're reading now) and no success or failure message.
  63. If you want to save the .OLH files for some reason, DON'T RUN PBQ.
  64.  
  65. Source Code
  66. ===========
  67. I've included the source code in C.  I used the Microsoft C compiler
  68. version 6.00AX; any recent Microsoft compiler should be able to compile
  69. this code without changes.  Minor changes will probably be necessary
  70. for other compilers.
  71.  
  72. If you write programs that would be useful to other Pacsat users, I
  73. would encourage you to release the source code too.  It really doesn't
  74. hurt you to do so.  Having the source code permits others to benefit
  75. from your efforts even if what you wrote isn't exactly what they need.
  76. They can fix bugs or make enhancements if they need to, even if it's
  77. 3:30 AM, and they may do it without any help from you!  So, if you're
  78. one of those who hoards the source code, what's your excuse?
  79.  
  80. All Software Has Bugs
  81. =====================
  82. ... and PBQ is probably no exception.  I'd be interested in any bug
  83. reports, or wishlist items, or other comments you may have about PBQ.
  84. As usual with free software, there's no guarantee of anything.
  85.  
  86. Legal Mumbo-Jumbo
  87. =================
  88. I retain the copyright on all software I write, on the off-chance that
  89. it might turn out to have commercial value.  So, no fair selling this
  90. program.  But you are welcome to use it for non-commercial purposes.
  91.  
  92. 73  -Paul Williamson, KB5MU
  93.  
  94. Pacsat:        AO-16, LO-19
  95. Internet:   pwilliamson@qualcomm.com
  96. Compu$erve: 75265,367
  97. Packet BBS: KB5MU @ KC6NZN.#SOCA.CA.USA.NA
  98.  
  99.